Oracle TimesTen In-Memory Database C開発者およびリファレンス・ガイド

ブックマークの削除

アプリケーションを終了する場合や表を削除する場合に、ブックマークを削除することがあります。アプリケーションが接続されており、現在ブックマークを使用している場合は、ttXlaDeleteBookmark C関数を使用してXLAブックマークを削除します。

ブックマークは、前の接続がクローズされた後に新しい接続で再利用できます（「XLAブックマークについて」を参照）。新しい接続は、前の接続が停止した場所からトランザクション・ログの読取りを再開します。次に、ブックマークを削除した場合のメリットおよびデメリットを示します。

ブックマークを削除すると、後続のチェックポイント（ttCkptまたはttCkptBlocking）処理によって、トランザクション・ログ内の未読の更新レコードに関連するディスク領域が解放されます。

ブックマークを削除しない場合、XLAアプリケーションは、接続してブックマークを再利用する際に、プログラムの終了以降累積していたすべての未読の更新レコードを読み取ります。これは、更新レコードがTimesTenトランザクション・ログで永続的であるためです。ただし、これらの未読のレコードがログ・ファイルに累積し、大量のディスク領域を使用すると危険です。

注意:

ブックマークを再利用する場合は、ログ・ファイル内の初期読取りLSNから開始します。ブックマークを再利用する接続で、現在の接続を切断した場所から読取りが開始されるようにするには、現在の接続を切断する前にttXlaAcknowledgeをコールして、ブックマークの位置を現在アクセスしているレコードに再設定する必要があります。

例3.19

xlaSimple.cデモのInitHandler関数は、終了時にXLAブックマークを削除します。

if (deleteBookmark) {

ttXlaDeleteBookmark(xla_handle);

if (rc != SQL_SUCCESS) {

/* 「XLAエラーの処理」を参照*/

}

xla_handle = NULL; /* Deleting the bookmark has the */

/* effect of disconnecting from XLA. */

}

/* Close the XLA connection（「XLAアプリケーションの終了」を参照） */

現在、アプリケーションが接続されておらず、XLAブックマークを使用している場合、次のいずれかの方法を使用してXLAブックマークを削除できます。

ブックマークをクローズしてttXlaBookmarkDeleteプロシージャをコールします。

ブックマークをクローズしてttIsqlのxladeletebookmarkコマンドを使用します。